Получение списка предложений

Запрос позволяет получить список городов, стран и аэропортов по тексту запроса.

Синтаксис запроса

GET https://b2b-api.go.yandex.ru/integration/integration/v2/avia/locations/suggest

Заголовки запроса

Authorization: Bearer <OAuth-токен>
Процесс получения токена описан в разделе Начало работы.

X-YaTaxi-Selected-Corp-Client-Id — идентификатор клиента из личного кабинета. Обязателен, если по токену доступно несколько клиентов.

Тело запроса

Данные передаются в формате JSON:

Поле	Описание	Формат	Обязательность
`query`	Текст для поиска, например: `"Mos"`	Строка	Да

В ответе могут содержаться следующие поля:

Поле	Описание	Формат	Обязательность
`suggests`	Список предложений.	Массив	Да

Структура объекта suggests:

Поле	Описание	Формат	Обязательность
`type`	Тип локации: `city`, `airport`, `country`.	Строка	Да
`title`	Название локации, например: `"Moscow"`.	Строка	Да
`point_key`	Уникальный ключ локации, например: `"c239"`.	Строка	Да
`point_code`	Код локации, например: `"MOW"`.	Строка	Нет
`city_title`	Название города, например: `"Moscow"`.	Строка	Нет
`country_id`	Идентификатор страны, например: `"c225"`.	Строка	Нет
`country_title`	Название страны, например: `"Russia"`.	Строка	Нет
`region_id`	Идентификатор региона, например: `"c10995"`.	Строка	Нет
`region_title`	Название региона, например: `"Moscow region"`.	Строка	Нет
`children`	Вложенные локации, например: аэропорты в городе.	Строка	Нет